Cara Pasang Beepos di Linux
===========================

Bisa dipakai di Ubuntu dan turunannya (Linux Mint, Zorin OS, Pop!_OS, dan
lain-lain) atau Debian, versi 64-bit. Tidak perlu memasang aplikasi apa pun
sebelumnya; cukup pastikan komputer terhubung ke internet selama instalasi.


Langkah pemasangan
------------------

1. Masuk ke Linux dengan akun yang nanti dipakai untuk kasir.
   Beepos dan shortcut-nya dipasang untuk akun ini.

2. Klik kanan berkas .zip yang diterima, pilih "Extract Here", lalu buka
   folder hasil ekstrak. Di dalamnya ada panduan ini dan berkas pasang-beepos.run.

3. Klik kanan di area kosong folder itu, pilih "Open in Terminal".

4. Ketik perintah berikut, lalu tekan Enter:

     bash pasang-beepos.run

5. Ikuti jendela yang muncul. Saat diminta password, masukkan password akun
   Linux yang dipakai sekarang. Tunggu sampai muncul tulisan
   "Beepos sudah terpasang". Prosesnya bisa beberapa menit.

6. Buka Beepos dari menu aplikasi atau shortcut di desktop, lalu masuk
   dengan akun Beepos seperti biasa.
   Kalau shortcut di desktop tidak bisa dibuka, klik kanan shortcut itu,
   lalu pilih "Allow Launching".


Yang dipasang
-------------

- Program Beepos, di folder /opt/beepos.
- Java 8 khusus untuk Beepos. Java lain yang sudah ada di komputer tidak
  diubah.
- Database PostgreSQL 15 di port 5433. Port ini sengaja berbeda dari port
  bawaan PostgreSQL (5432) supaya tidak bentrok dengan aplikasi lain. Kalau
  5433 sudah terpakai, installer otomatis memakai port kosong berikutnya.
  Kalau di komputer sudah ada PostgreSQL 15, yang lama dipakai apa adanya,
  dan database di dalamnya tidak dihapus.


Kalau ada kendala
-----------------

- Catatan proses instalasi tersimpan di /var/log/beepos-install.log.
  Kirim berkas ini ke tim Beepos saat melapor.

- Untuk melihat catatan saat Beepos berjalan, buka Terminal lalu ketik:

     /opt/beepos/beepos.sh ui

- Untuk menghapus Beepos (database tidak ikut terhapus), buka Terminal lalu
  ketik:

     sudo bash /opt/beepos/uninstall.sh
